home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / ProgramD2.iso / Visual Database / Visual dBase v5.5 / README.TXT < prev    next >
Text File  |  1995-07-18  |  33KB  |  705 lines

  1.  
  2.                     Welcome to Visual dBASE
  3.                     -----------------------
  4.  
  5. This file contains important, late-breaking information about Visual 
  6. dBASE, including updates to the printed documentation. 
  7.  
  8. TABLE OF CONTENTS
  9. -----------------
  10.  1. Configuration and System Requirements
  11.  2. Distributing Visual dBASE Applications
  12.  3. Accessing Database Servers with Visual dBASE
  13.  4. dBASE SpeedFilter Optimization
  14.  5. Documentation Updates
  15.  6. Borland Database Engine Configuration Notes
  16.  7. Using the ODBC Socket
  17.  8. Windows 95 Issues
  18.  9. Automated Registration Notes
  19. 10. dBASE for Windows 5.0 Compatibility Issues
  20. 11. dBASE DOS Compatibility Tips
  21. 12. Windows Colors Settings
  22. 13. Running the dBClock Sample Program with Dashboard
  23. 14. Common Questions & Answers
  24. 15. Working with FoxPro Tables
  25. 16. Installing Adobe(R) Acrobat(TM)
  26. 17. dBASE Magazines and Supporting Products 
  27. 18. Acknowledgments
  28.  
  29. Additional Help and text files contain valuable information about working
  30. with Visual dBASE:
  31.  
  32.    CUSTOM.TXT in \VISUALDB\CUSTOM contains information about the Visual 
  33.    dBASE Custom Controls.
  34.    
  35.    dBASESQL.HLP in \VISUALDB\BIN contains information about using Borland 
  36.    SQL Links with Visual dBASE.
  37.  
  38.    EXTERN.TXT in \VISUALDB\SAMPLES\EXTERN describes the samples that
  39.    illustrate using the Extern System.
  40.    
  41.    SAMPLES.TXT in \VISUALDB\SAMPLES describes the sample program files.
  42.  
  43.    UTILS.TXT in \VISUALDB\UTILS contains information on using the Visual
  44.    dBASE utility programs.   
  45.  
  46.  
  47. 1. CONFIGURATION AND SYSTEM REQUIREMENTS
  48. -----------------------------------------
  49. System requirements:
  50.   - Intel 386-based PC or higher
  51.   - Windows 3.1, Windows 95, or 100% compatible
  52.   - 6 MB RAM required, 8 MB recommended
  53.   - 29 MB free disk space for a complete installation
  54.   - 11.5 MB free disk space for minimum installation
  55.   
  56.   Visual dBASE is compatible with Win-OS/2 and Windows 3.1 running
  57.   under OS/2 Warp.
  58.  
  59. Supported network operating systems:
  60.   Netware 3.11, 3.12, 4.1
  61.   Personal Netware
  62.   Banyan Vines 5.5
  63.   IBM OS/2 LAN Server 4.0 *
  64.   Lantastic 6.0
  65.   Microsoft LAN Manager 2.2
  66.   Windows for Workgroups 3.11 **
  67.   Windows NT Server 3.5 **
  68.  
  69.   * For proper operation of Visual dBASE with LanServer 4.0, change
  70.   the following parameters in the DOSLAN.INI file on the workstation:
  71.     NBS: 4K
  72.     BBS: 5K
  73.       
  74.   ** If the server is also used as a workstation, the LOCALSHARE setting in
  75.   the System page of the BDE Configuration Utility must be set to True. 
  76.   Without this setting, record and file locking will not be performed at 
  77.   the server.
  78.  
  79. To open Crystal Reports Personal Trainer from within Crystal Reports
  80. Help, you must have the \VISUALDB\CRYSTAL directory in your DOS path.
  81.  
  82. On a single machine, to access the same table concurrently using Sessions 
  83. or multiple instances of Visual dBASE, the DOS SHARE.EXE utility must be 
  84. loaded before starting Windows with the command:
  85.   SHARE /F:4096 /L:40 
  86.  
  87. Also see section 6 of this README file, "BDE Configuration Notes."
  88.  
  89.  
  90. 2. DISTRIBUTING VISUAL DBASE APPLICATIONS
  91. -----------------------------------------
  92. The Visual dBASE Compiler is an optional, separately purchased, add-on 
  93. product for Visual dBASE. It compiles and links Visual dBASE programs, 
  94. forms, reports, bitmaps, and other code and resources into a Windows 
  95. executable which can be distributed royalty-free and run on systems
  96. which do not have Visual dBASE installed.
  97.     
  98. To learn how to build and distribute Windows executables with the Visual
  99. dBASE Compiler, see the Programmer's Guide and the online Help.    
  100.  
  101.  
  102. 3. ACCESSING DATABASE SERVERS WITH VISUAL DBASE
  103. -----------------------------------------------
  104. Visual dBASE can be used to create powerful client/server applications
  105. using a variety of popular database servers. Visual dBASE Client/Server
  106. includes all the software required to do client/server development. Visual
  107. dBASE Client/Server includes:
  108.  
  109.   * Borland SQL Links for:
  110.     - Borland Interbase
  111.     - Informix
  112.     - Microsoft/Sybase SQL Server
  113.     - Oracle
  114.   * Borland's Local Interbase Server for developing and testing
  115.     client/server applications.
  116.   * The Data Pump Expert to easily move tables between platforms.
  117.   * The Visual dBASE Compiler for compiling applications to Windows
  118.     executables and royalty-free distribution.    
  119.   * Resource Workshop for easily creating Windows resources using visual
  120.     tools.
  121.     
  122. For information on upgrading to Visual dBASE Client/Server contact
  123. Borland or your local reseller.
  124.     
  125.  
  126. 4. dBASE SPEEDFILTER OPTIMIZATION
  127. ---------------------------------
  128. dBASE SpeedFilters provide the fastest access to your dBASE tables. See
  129. the "About SpeedFilters" topic under "Visual dBASE Basics" in the dBASE 
  130. online Help file for more information.
  131.  
  132.  
  133. 5. DOCUMENTATION UPDATES
  134. -------------------------
  135. User's Guide updates
  136.  
  137.   - See section 1 of this README file for an updated list of supported
  138.     networks.
  139.  
  140.   - When installing Visual dBASE under Windows 95 or Windows NT, Visual
  141.     dBASE may not automatically register with the operating system. To 
  142.     insure this process is completed, double-click on the VISUALDB.REG file
  143.     in the \VISUALDB\BIN directory immediately after the installation 
  144.     completes.
  145.  
  146.   - Navigator and Command Window changes: Double-clicking the Control menu
  147.     box or choosing File|Close minimizes these windows.
  148.  
  149.   - The number of tables in a query is limited by the number of
  150.     work areas (225).
  151.   
  152.   - The section called "OEM and ANSI conversions" on pages 316-317 is 
  153.     incorrect. This material is discussed in the help correctly. To find 
  154.     this information, search for OEM in the help, then choose the topic 
  155.     "Converting between OEM and ANSI text".
  156.  
  157.   - To get context-sensitive help from the command line or while editing
  158.     programs, select the command, function, or another language element 
  159.     name and press F1.  If the language element selected is fully spelled
  160.     out, the corresponding help topic appears.
  161.     
  162.   - Note on creating a form in the Form Designer based on a Custom Form
  163.     Class: When an object on the form is selected, the handles (the small 
  164.     squares surrounding the selected object) appear in black if the object
  165.     is defined on the current form, and appear in white if the object was 
  166.     inherited from the parent form class. Changes made to inherited objects
  167.     (those with white handles) will be reflected only in the current form.
  168.     The parent form and its objects will be unaffected. To change the
  169.     custom form class, the custom form must be modified directly.
  170.  
  171. Language Reference/Programmer's Guide updates
  172.  
  173.   - Online Help is your most up-to-date source of information on the dBASE
  174.     language.
  175.  
  176.   - The following properties are not documented in the Language Reference,
  177.     but are documented in the online Help:  DesignView, CanNavigate,
  178.     RefreshAlways, and OnDesignOpen.
  179.     
  180.   - The following commands and functions are not documented in the
  181.     Language Reference, but are documented in the online Help: ADIREXT()
  182.     and EXTERN SQL.
  183.     
  184.   - Using LOCAL or STATIC variables, or properties of LOCAL or STATIC
  185.     objects, in a <condition> of the LOCATE or SET FILTER commands is not 
  186.     allowed.  Use a PUBLIC or PRIVATE variable, or a PUBLIC or PRIVATE 
  187.     object, instead. This restriction also applies to the use of properties
  188.     of the objects THIS or FORM in the <condition>, since THIS and FORM
  189.     have LOCAL scope.
  190.  
  191.   - PaintBox objects have an OnClose event. This is not documented in the
  192.     Language Reference.            
  193.     
  194.   - Note on the CanNavigate() event: When the CanNavigate event handler
  195.     is used, the event handler must return .T. for the user to be allowed
  196.     to navigate between records. If the CanNavigate event handler returns 
  197.     .F., the user cannot leave the current record.
  198.  
  199.   - The syntax for expression codeblocks in the Language Reference and
  200.     on-line Help is incorrect. The correct syntax is:
  201.       {|[<parameters>]| <expression>}
  202.     The pipes ( || ) are required even if no parameters are passed. The
  203.     syntax is documented correctly in the Programmer's Guide.  
  204.  
  205.   - The Language Reference incorrectly says that the default setting of 
  206.     SET LDCHECK is ON. The default setting is actually OFF.
  207.     
  208.   - Correction to the Local SQL INSERT INTO command: The <column list> is
  209.     not optional for local tables.
  210.     
  211.   - Correction to the SET KEY TO command: Replace the beginning of the
  212.     syntax discussion with the following:
  213.       <exp list 1> | RANGE <exp 2> [,] | ,<exp 3> | <exp2>, <exp3>
  214.       Specifies a condition that filters records. For Paradox and SQL 
  215.       tables, <exp list 1> can contain values (separated by commas) that 
  216.       match composite index key fields.
  217.       
  218.   - Replace the syntax statement in the Local SQL CREATE TABLE command with
  219.     the following:
  220.       CREATE TABLE <table name> (<column name> <data type> 
  221.         [ , <column name> <data type>...] 
  222.         [ , PRIMARY KEY ( <column list> ) ]
  223.         )       
  224.  
  225.   - When the structure of a database server table is changed, the database 
  226.     should be closed and re-opened before continuing to use the table; 
  227.     otherwise, dBASE may behave as if the table structure is unchanged. A 
  228.     workaround is to go into the BDE Configuration Utility, and on the 
  229.     Drivers page, change the schema cache size from its default of 8 to 0. 
  230.     However, this workaround should only be used during development and 
  231.     testing of applications because it will have a negative impact on 
  232.     performance.
  233.     
  234.   - When forms containing Visual dBASE custom controls are generated via 
  235.     the Form Designer, the full path to the location of the custom-control 
  236.     files on that machine is stored in the .WFM file. To distribute an 
  237.     application with custom-control files, edit the .WFM file to remove the 
  238.     full path. Then copy the custom-control files to the directory where 
  239.     the .WFM is stored.
  240.  
  241.   - On database servers where a unique row identification method is not
  242.     available (such as a primary key or unique index), issuing a REFRESH 
  243.     command will clear any SET FILTERs and SET RELATIONs that were active.
  244.  
  245.   - Do not issue a REFRESH command against Views or read-only SQL result 
  246.     tables. Reissue the SELECT command instead.  
  247.  
  248. Upgrade Guide updates (applies only to the upgrade product)
  249.  
  250.   - The MarkCustom() method described in Chapter 6 does not exist. Its 
  251.     functionality is built into the Form Designer.
  252.  
  253.  
  254. 6. BORLAND DATABASE ENGINE (BDE) CONFIGURATION NOTES
  255. -----------------------------------------------------
  256. Your DBASEWIN.INI file lets you specify a default BDE configuration file to 
  257. use whenever Visual dBASE is started.  However, if another, non-dBASE, 
  258. BDE-based product is already running with a different BDE configuration 
  259. file when you try to start Visual dBASE, Visual dBASE will issue an error 
  260. and will not start.
  261.  
  262. Choose the BDE Configuration Utility icon from Windows Program Manager 
  263. to edit the configuration file. When you open the utility it will display 
  264. the IDAPI.CFG specified in the BDE section of the WIN.INI file.
  265.  
  266. You might need to change some or all of the following IDAPI.CFG settings:
  267.  
  268.   - DBASE FILE TYPE -- During installation, if a BDE configuration file 
  269.     exists on your machine, its settings are read into the new BDE
  270.     configuration file. This may cause the dBASE FILE TYPE level to be set 
  271.     to 4 (the dBASE IV level). To use Visual dBASE specific field types 
  272.     (i.e. Binary and OLE), set DBASE FILE TYPE to 5. 
  273.  
  274.   - LOCAL SHARE -- If you are not on a network, and it is possible to have
  275.     Visual dBASE and other non-BDE software products accessing the same
  276.     tables at the same time, you need to set LOCAL SHARE (System Page) to
  277.     TRUE and have the DOS SHARE.EXE program loaded in memory.
  278.  
  279.   - NET DIR -- If you are using Paradox tables, or are executing SQL
  280.     commands through Local or Remote SQL or SQLEXEC() on a shared drive 
  281.     (network), you must enter a valid path into the IDAPI.CFG's Paradox 
  282.     driver NET DIR setting.  See the instructions above on how to use the 
  283.     BDE Configuration Utility. 
  284.   
  285. Placement of the Borland Database Engine (BDE) files:
  286.  
  287.   If you are installing Visual dBASE on a workstation that already 
  288.   contains a copy of the Borland Database Engine, install the Visual dBASE
  289.   BDE files to the same directory.  Typically, this directory is called 
  290.   \IDAPI.
  291.   
  292.   If you have an existing installation of the BDE, the installation program
  293.   copies your default BDE configuration file to whatever location you
  294.   specified for your Visual dBASE BDE files.  (Your default BDE 
  295.   configuration file is specified in the BDE section of your WIN.INI file
  296.   as CONFIGFILE01.) 
  297.   
  298.   If the CONFIGFILE01 setting does not exist in your WIN.INI and you do not
  299.   have an IDAPI.CFG file, a new IDAPI.CFG file is created in the same 
  300.   directory where you installed your Visual dBASE BDE files. The 
  301.   installation program changes the CONFIGFILE01 setting to point to 
  302.   IDAPI.CFG at this new location.
  303.  
  304.   
  305. 7. USING THE ODBC SOCKET
  306. -------------------------
  307. Visual dBASE includes support in the Borland Database Engine for an ODBC 
  308. Socket. It has been certified with Microsoft's 2.0 ODBC Driver Manager. If
  309. you have a different version of the ODBC Driver Manager, back up your 
  310. existing ODBC.DLL and ODBCINST.DLL and copy the version 2.0 files ODBC.NEW 
  311. and ODBCINST.NEW files from your BDE directory to your \WINDOWS\SYSTEM 
  312. directory, renaming them to ODBC.DLL and ODBCINST.DLL. 
  313.  
  314. The driver description in the ODBC.INI file must match the driver name
  315. exactly as found in the ODBCINST.INI file in order for the BDE 
  316. Configuration Utility to add drivers to the BDE configuration file. 
  317.  
  318. When using ODBC data sources with the Auto ODBC option set to True and
  319. a driver name greater than 32 characters, the BDE truncates the name to
  320. 32 characters. These truncated drivers do not appear in the driver list
  321. within BDECFG.EXE. Therefore they cannot be deleted from the 
  322. configuration file.  Every time that the Auto ODBC option is set to True
  323. these drivers are added repeatedly to the configuration file after every 
  324. save - thus the configuration file keeps growing and there is no way to 
  325. remove the excess drivers. To avoid this problem do not use driver names 
  326. greater than 32 characters in length.
  327.  
  328. For information on how to create an ODBC driver connection and alias, 
  329. search for "ODBC Driver Connection" in the BDE Configuration Utility 
  330. online Help file.
  331.  
  332.  
  333. 8. WINDOWS 95 ISSUES
  334. --------------------
  335. - When installing Visual dBASE under Windows 95 or Windows NT, Visual
  336.   dBASE may not automatically register with the operating system. To 
  337.   insure this process is completed, double-click on the VISUALDB.REG file
  338.   in the \VISUALDB\BIN directory immediately after the installation 
  339.   completes.
  340.  
  341. - The BDE does not support the Windows 95 Universal Naming Conventions
  342.   for accessing network servers as directories in this release.
  343.   Therefore, a command such as:
  344.  
  345.     USE \\MYSERVER\MYDATA\MYTABLE.DBF
  346.  
  347.   does not work. A workaround is to map the server/directory to a drive.
  348.   For example, if in the command above we mapped \\MYSERVER to drive G:,
  349.   the command could be entered as:
  350.  
  351.     USE G:\MYDATA\MYTABLE.DBF
  352.  
  353.   which would work.    
  354.  
  355. - Windows 95 requires double quotes around a filename that includes
  356.   embedded spaces when executing a program.  Therefore in the RUN() 
  357.   command, extra delimiters (square brackets or single quotes) must be 
  358.   supplied around such filenames.  For example:
  359.     
  360.     RUN(.T., ["C:\PROGRAM FILES\ACCESSORIES\MSPAINT.EXE"])      
  361.  
  362.  
  363. 9. AUTOMATED REGISTRATION NOTES
  364. -------------------------------
  365. Visual dBASE features an automated registration system which allows you to
  366. register your software with Borland at the time you install the product. 
  367. Registration is accomplished via modem, if a modem is available, or by 
  368. printing out and mailing or faxing your registration information.
  369.  
  370. If you start, but do not complete, the automated registration when you
  371. install Visual dBASE, you will be automatically reminded to register after 
  372. 14 days. This reminder can be disabled by removing the command 
  373. "C:\VISUALDB\VDB55REG\remind.exe" from the line that begins "load=" in the 
  374. WIN.INI file in your Windows directory.
  375.  
  376. Under Windows NT, the steps to disable the reminder are different. The
  377. steps are:
  378.   - Double-click on REGEDT32.EXE in the \WINDOWS\SYSTEM32 directory.
  379.   - Find the "HKEY_CURRENT_USER on Local Machine" window.
  380.   - Search the tree for Software\Microsoft\WindowsNT\CurrentVersion\Windows
  381.   - Double-click on the "load" item to bring up the String Editor.
  382.   - Remove the entry for REMIND.EXE from the string.
  383.  
  384. Once you have registered, you can safely remove the directory
  385. \VISUALDB\VDB55REG and the files contained therein.
  386.  
  387.  
  388. 10. dBASE FOR WINDOWS 5.0 COMPATIBILITY ISSUES
  389. ----------------------------------------------
  390. - Note that for expression codeblocks, the Visual dBASE syntax is:
  391.     {|[<parameters>]|<expression>}
  392.   The pipes ( || ) are now required even if no parameters are passed. In
  393.   dBASE for Windows 5.0 the pipes were optional if no parameters were 
  394.   passed.
  395.  
  396. - Forms created using dBASE for Windows 5.0 that used the BUTTONS.CC 
  397.   custom control library, or resources from other files which resided in 
  398.   the \DBASEWIN directory tree, may need to be modified. In some cases the
  399.   full path to a file was inserted in the .WFM file. Since the base 
  400.   directory for Visual dBASE is now \VISUALDB, not \DBASEWIN, the path to
  401.   the file will need to be corrected.
  402.  
  403. - The default ComboBox style is now 1 (DropDown).
  404.  
  405. - SET CONFIRM now defaults to ON.
  406.  
  407.  
  408. 11. dBASE DOS COMPATIBILITY TIPS
  409. --------------------------------
  410. Declaring a variable PRIVATE that is in use as the screen name for SAVE 
  411. SCREEN TO <screen name> returns the run-time error "Variable undefined: 
  412. <screen name>". Visual dBASE handles <screen name> differently than 
  413. dBASE for DOS; it creates <screen name> as a PUBLIC memory variable. 
  414.  
  415. Visual dBASE does not run dBASE DOS Label and Report binary files (.LBL 
  416. and .FRM). Use the Component Builder to convert them to Crystal Reports 
  417. files (.RPL and .RPT). dBASE DOS .LBG and .FRG label and report files may 
  418. be run as source code. 
  419.  
  420. dBASE DOS queries that contain sort instructions cannot be used by the 
  421. Component Builder and Crystal Reports for dBASE. In the case of QBEs that 
  422. SORT, please see A10 in the Common Questions & Answers section below. 
  423.  
  424. To honor Windows keystroke behavior, Ctrl+Home and Ctrl+End no longer open 
  425. and close memo fields. Use F9 to open them; use F9, Ctrl+W, or <Esc> to 
  426. close them. 
  427.  
  428. F9 and double-click are used to open memo, OLE, and binary fields in Visual
  429. dBASE. If your application uses the ON KEY LABEL F9 <command> to redefine 
  430. F9 for these fields, double-click on the icons to open them. 
  431.  
  432. The SET STATUS ON/OFF command is not supported (returns a warning) in
  433. Visual dBASE. However, you may still use the Application page of the 
  434. Desktop Properties dialog box to turn the status bar on or off. You can 
  435. also do this via the DBASEWIN.INI file, by changing the setting of 
  436. StatusBar to OFF or ON in the Desktop section. This must be done before 
  437. starting Visual dBASE. 
  438.  
  439. APPEND FROM ARRAY will require matching data types between the array 
  440. element and the corresponding field in the table. This is not required in 
  441. dBASE for DOS. 
  442.  
  443. Visual dBASE does not support dBASE DOS PLAY MACRO, SAVE MACROS, or 
  444. RESTORE MACROS commands. dBASE DOS MACRO.KEY files must be converted to a 
  445. Windows macro format or reprogrammed under Visual dBASE as functions. 
  446.  
  447. When installed on a standalone machine, Visual dBASE does not change 
  448. the default for SET EXCLUSIVE to ON; however, dBASE DOS does. Because of 
  449. this, you might want to SET EXCLUSIVE ON at the top of dBASE DOS 
  450. applications run under Visual dBASE that require exclusive use of tables. 
  451.  
  452. In Visual dBASE, a new return value has been added to the READKEY() 
  453. function to indicate that no update has occurred. READKEY() returns 14 if 
  454. an unchanged record is left by pressing Ctrl+W or Ctrl+End. 
  455.   
  456. Visual dBASE uses SET DELETED ON as the default setting. If you want 
  457. the default to be OFF you must go to the Tables page of the Desktop 
  458. Properties dialog box to set the default to either ON or OFF. Another way 
  459. of doing this is in the DBASEWIN.INI file, where you can change the setting 
  460. of DELETED to OFF or ON in the "OnOffCommandSettings" section. This must be 
  461. done before starting Visual dBASE.
  462.  
  463.  
  464. 12. WINDOWS COLOR SETTINGS
  465. --------------------------
  466. Default color settings are taken from the settings in the Windows Control
  467. Panel.  You can use color settings for the color properties of controls
  468. and with the SET COLOR command.  The following chart shows the available
  469. color settings and the corresponding setting from the Windows Control 
  470. Panel.  See the online help for the ColorNormal property for usage.
  471.  
  472. Color Setting         Windows 3.1 Control Panel   Windows 95 Control Panel
  473. ===================   =========================   ========================
  474. ActiveBorder          Active Border               Active Window Border
  475. ActiveCaption         Active Title Bar            Active Title Bar
  476. AppWorkSpace          Application Workspace       Application Background
  477. BackGround            Desktop                     Desktop
  478. BtnFace               Button Face                 3D Objects
  479. BtnHighlight          Button Highlight            3D Objects
  480. BtnShadow             Button Shadow               3D Ojbects
  481. BtnText               Button Text                 3D Objects
  482. CaptionText           Active Title Bar Text       Active Title Bar
  483. GrayText              Disabled Text               <not configurable>
  484. Highlight             Highlight                   Menu
  485. HighlightText         Highlight Text              Menu
  486. InactiveBorder        Inactive Border             Inactive Window Border
  487. InactiveCaption       Inactive Title Bar          Inactive Title Bar
  488. InactiveCaptionText   Inactive Title Bar Text     Inactive Title Bar
  489. Menu                  Menu Bar                    Menu
  490. MenuText              Menu Text                   Menu
  491. Scrollbar             Scroll Bars                 3D Objects
  492. Window                Window Background           Window
  493. WindowFrame           Window Frame                <not configurable>
  494. WindowText            Window Text                 Window
  495.  
  496.  
  497. 13. RUNNING THE DBCLOCK SAMPLE PROGRAM WITH DASHBOARD
  498. -----------------------------------------------------
  499. If you use the optional Visual dBASE Compiler to compile the sample program
  500. dBClock to an .EXE file, and you use Dashboard from Starfish Software,
  501. dBClock will not run. This is caused by a naming conflict; Dashboard has a 
  502. DLL called DBCLOCK.DLL. A simple workaround is to rename the .EXE so the
  503. name does not conflict.  For example, rename DBCLOCK.EXE to DBCLOCK1.EXE.
  504.  
  505.  
  506. 14.  COMMON QUESTIONS & ANSWERS
  507. -------------------------------
  508. Q1:  How much hard disk space do I need to install Visual dBASE?
  509.  
  510. A1:  Full Installation requires 24 MB. If space is a problem, select
  511. Custom Installation and omit the options you don't need. Minimum
  512. Installation requires 10 MB of hard disk space. In addition, you should
  513. have 1.5 MB of free drive space on the drive/partition where Windows is
  514. installed (if installing on a different drive/partition). When using a
  515. compressed drive, allow a plus 20 percent margin.
  516.  
  517. Q2:  The User's Guide says 6 MB of RAM is required (8 MB preferred). Will
  518. Visual dBASE run on a 4MB machine?
  519.  
  520. A2:  A 4 MB RAM machine has 3 MB of extended memory available before
  521. anything else is loaded into extended memory. Typically, Windows 3.1
  522. has SMARTDRIVE installed which takes 1 MB of extended memory. The 2 MB of
  523. extended memory remaining is then used by Windows in conjunction with a 
  524. (Windows) swap file created on your hard drive. All your Windows programs
  525. will be sharing this limited resource. Visual dBASE will likely run 
  526. on this environment but with reduced performance. The product is 
  527. recommended for machines that have the specified (6 MB or more) amount of
  528. RAM.
  529.  
  530. Q3:  How do I access Windows memory management controls?
  531.  
  532. A3:  a) Choose the Windows Control Panel.
  533.      b) Choose 386 Enhanced.
  534.      c) Click the Virtual Memory pushbutton.
  535.      d) Click the Change pushbutton.
  536.      e) Choose "Permanent Swap File".
  537.      f) Increase the value of the New Size option.
  538. Consult your Windows documentation for further information.
  539.  
  540. Q4:  Can dBASE for DOS and Visual dBASE be installed on the same machine?
  541. Which one will start when I issue the dBASE command at DOS with dBASE in 
  542. my PATH?
  543.  
  544. A4:  dBASE for DOS (dBASE IV or dBASE 5.0) starts by calling DBASE.EXE.
  545. Visual dBASE has an executable file named DBASEWIN.EXE. The command
  546. DBASE, issued at DOS, will execute dBASE for DOS.  On a system with Windows
  547. 3.1, the command DBASEWIN, issued at DOS, will give you a DOS error "Not a 
  548. DOS Program." You must start Windows first. The command WIN DBASEWIN from 
  549. DOS will start Visual dBASE. Typically Visual dBASE will be run from the 
  550. Program Manager in Windows 3.1. Windows 95 does not use DOS, but can 
  551. emulate a DOS command line.  Issuing the DBASEWIN command at a Windows 95 
  552. "DOS" prompt will start Visual dBASE.
  553.  
  554. Q5:  All my old data files (.DBF, .DBT, .MDX, .QBE, .FMT, .FRG, etc.) are
  555. located on my C:\DBASE or C:\DBASE\DATA subdirectory. Do I have to move
  556. them to the VISUALDB directory?
  557.  
  558. A5:  Subdirectory selection is easy from the Navigator in Visual dBASE. 
  559. Enter the correct path in the entry field or click the file icon to select
  560. a new directory. Files in various directories can also be organized in a 
  561. catalog. When running Visual dBASE, it is ok to change the current 
  562. directory to a directory on which dBASE for DOS is installed to access 
  563. data files.
  564.  
  565. Q6:  Where can I get more examples on programming with Visual dBASE?
  566.  
  567. A6:  Additional samples and example source code are available in the Visual
  568. dBASE forum on CompuServe, and at Borland's World Wide Web site on the 
  569. Internet (http://www.borland.com).
  570.  
  571. Q7:  As a dBASE DOS user, sessions are new to me. Where can I get more
  572. information about how these work?
  573.  
  574. A7:  See the "About Sessions" topic under "Visual dBASE Basics" in
  575. the dBASE online Help system. An article is also available on the
  576. Borland TechFax machine; obtain a catalog by calling 1-800-822-4269.
  577.  
  578. Q8:  When starting Visual dBASE, I receive the error "Buttons.cc not
  579. found"; however, this file is located on my network drive. What do I need
  580. to change in my configuration?
  581.  
  582. A8:  Edit your DBASEWIN.INI file, usually located in your \VISUALDB\BIN 
  583. directory, and locate the [CustomClasses] section. Look for the line 
  584. beginning with CC that specifies the location of your BUTTONS.CC file. Make 
  585. sure the line has the proper path to the location of your BUTTONS.CC file. 
  586. This file should be located in your \VISUALDB\SAMPLES directory. Then 
  587. restart Visual dBASE. 
  588.  
  589. Q9:  I have a large application written in dBASE IV 2.0. What do I need to 
  590. do to run this application in Visual dBASE? 
  591.  
  592. A9:  You can run your program from the Command window; however, your
  593. program will only be displayed in the results pane. You can convert your
  594. code to Windows type code using the Component Builder included with Visual 
  595. dBASE. For further information on using the Component Builder, load the 
  596. Component Builder by clicking its icon and see the Conversion Guidelines in
  597. the Component Builder online Help file.
  598.  
  599. Q10:  When I run or design a report based on a sorted Query, my fields
  600. disappear from the report. How do I see my fields?
  601.  
  602. A10:  This is because the sorted query creates a temporary file with a
  603. unique name, each time the query is executed. We recommend that you
  604. perform the sort in the report designer. Alternately, you can edit
  605. the query as a program and change the variable assignment of SORT___001
  606. to a unique specific file name like SORT___001 = "NEW" and delete the
  607. rest of the line. You should add a line, SET SAFETY OFF, before the
  608. variable assignment, and add a line at the end of the QBE, SET SAFETY
  609. ON. Now you are ready to build a new report on this query. More
  610. complete details are available on the Borland TechFax machine; obtain a
  611. catalog at 1-800-822-4269.
  612.  
  613. Q11:  What do I need to do before creating Referential Integrity rules
  614. for Paradox tables?
  615.  
  616. A11:  Before creating referential integrity (RI) rules for Paradox tables,
  617. all tables must have a Primary Key defined. To create an RI rule based on a
  618. one-to-many link between tables, the child table's linked field must have
  619. a secondary index.
  620.  
  621. Q12:  How can I make sure a PaintBox control correctly processes the
  622. Windows OnPaint messages?
  623.  
  624. A12:  In the OnPaint event of you PaintBox control, you should use either
  625. the BeginPaint() and EndPaint() functions to bracket your paint routine, or 
  626. use the ValidateRect() or ValidateRgn() functions. This will prevent your 
  627. control from receiving excessive Paint messages. These functions are all 
  628. Windows API calls, and are prototyped as EXTERN functions in the WINAPI.H 
  629. header file that comes with Visual dBASE.
  630.  
  631.  
  632. 15.  WORKING WITH FOXPRO TABLES
  633. -------------------------------
  634. Visual dBASE can open, read, and write to FoxPro tables as follows:
  635.    .DBF - FoxPro table file
  636.    .CDX - FoxPro multiple index file
  637.    .FPT - FoxPro table memo file
  638.  
  639. 1. If the table has no production index, memo field, or general field,
  640.    Visual dBASE will open it and read and write data to it.
  641.  
  642. 2. If the table has a production index (.CDX), you have an option to
  643.    open it read-only, which ignores the .CDX file, or create a new
  644.    .MDX file with the same index tags as are in the .CDX file.
  645.  
  646. 3. If the table has a memo field or general field (.FPT), you have the
  647.    option to open it, and read and write to it, as a non-dBASE table.
  648.    If the table has a general field with OLE documents in them, dBASE
  649.    for Windows can read and write them.
  650.  
  651.    You can also open the table and convert the memo or general field
  652.    (.FPT) to the dBASE .DBT format. If you convert it, the original
  653.    .FPT file is deleted, so you should make a backup of the table
  654.    before converting.
  655.  
  656.  
  657. 16.  INSTALLING ADOBE(R) ACROBAT(TM)
  658. ------------------------------------
  659. NOTE: This section applies only to the version of Visual dBASE
  660. distributed on CD-ROM.
  661.  
  662. To install the Adobe Acrobat Reader manually: 
  663.   1. place the Visual dBASE CD in the CD-ROM drive.
  664.   2. Run the program d:\INSTALL.ADB\ACROREAD.EXE, where "d:" is
  665.      the drive letter of your CD-ROM.
  666.   3. In Program Manager, drag the Adobe Acrobat Reader icon into the 
  667.      Visual dBASE Program Group.
  668.   4. With the icon selected, select File | Properties on the Program
  669.      Manager menu bar.
  670.   5. Add the following to the end of the command line statement:
  671.        d:\BOOKS\STARTUP.PDF
  672.      where d: is the drive letter of your CD-ROM
  673.      
  674. Windows 95 and Windows NT users should be aware that the Acrobat
  675. installation program will reboot Windows at the completion of the
  676. installation.
  677.  
  678. This version of the Acrobat Reader will not run under Windows NT. Windows
  679. NT users should contact Adobe for information on availability of an Acrobat
  680. reader that is compatible with Windows NT.
  681.  
  682.  
  683. 17.  dBASE MAGAZINES AND SUPPORTING PRODUCTS
  684. --------------------------------------------
  685. See the "Companion Products and Services" Help file for information on
  686. additional software, training, books, and magazines that support Visual 
  687. dBASE.
  688.  
  689.  
  690. 18.  ACKNOWLEDGMENTS
  691. --------------------
  692. Some of the sound files were provided by Programmer's Warehouse from Sound 
  693. Explosion for Windows. Copyright (c) 1992-1994 Programmer's Warehouse. All 
  694. rights reserved. Licensed sounds Copyright (c) 1990-1992 The Hollywood 
  695. Edge. 
  696.  
  697. Sample music database provided by AudioFile, providers of current 
  698. information for the retail music industry. Product listed in this database 
  699. is available through Sound Delivery, 1280 Santa Anita Court, Woodland, CA 
  700. 95776. 
  701.  
  702. Sampled music provided by Southern Library of Recorded Music, 6777 
  703. Hollywood Boulevard, Los Angeles, CA 90028, (213) 469-9910. 
  704.  
  705.